<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>GIOError</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="index.html" title="GIO Reference Manual">
<link rel="up" href="file_ops.html" title="File Operations">
<link rel="prev" href="GMountOperation.html" title="GMountOperation">
<link rel="next" href="file_mon.html" title="File System Monitoring">
<meta name="generator" content="GTK-Doc V1.9 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="pt01.html" title="Part&#160;I.&#160;GIO Overview">
<link rel="chapter" href="ch01.html" title="Introduction">
<link rel="chapter" href="ch02.html" title="Compiling GIO applications">
<link rel="chapter" href="ch03.html" title="Running GIO applications">
<link rel="chapter" href="gio-extension-points.html" title="Extending GIO">
<link rel="part" href="pt02.html" title="Part&#160;II.&#160;API Reference">
<link rel="chapter" href="file_ops.html" title="File Operations">
<link rel="chapter" href="file_mon.html" title="File System Monitoring">
<link rel="chapter" href="async.html" title="Asynchronous I/O">
<link rel="chapter" href="streaming.html" title="Streaming I/O">
<link rel="chapter" href="types.html" title="File types and applications">
<link rel="chapter" href="volume_mon.html" title="Volumes and Drives">
<link rel="chapter" href="icons.html" title="Icons">
<link rel="chapter" href="utils.html" title="Utilities">
<link rel="chapter" href="extending.html" title="Extending GIO">
<link rel="part" href="migrating.html" title="Part&#160;III.&#160;Migrating to GIO">
<link rel="chapter" href="ch14.html" title="Migrating from POSIX to GIO">
<link rel="chapter" href="ch15.html" title="Migrating from GnomeVFS to GIO">
<link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy">
<link rel="index" href="ix01.html" title="Index">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GMountOperation.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="file_ops.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GIO Reference Manual</th>
<td><a accesskey="n" href="file_mon.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2780296" class="shortcut">Top</a>
                  &#160;|&#160;
                  <a href="#id2801834" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="gio-GIOError"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2780296"></a><span class="refentrytitle">GIOError</span>
</h2>
<p>GIOError &#8212; Error helper functions</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">

#include &lt;gio/gio.h&gt;


#define             <a class="link" href="gio-GIOError.html#G-IO-ERROR:CAPS">G_IO_ERROR</a>
enum                <a class="link" href="gio-GIOError.html#GIOErrorEnum">GIOErrorEnum</a>;
<a class="link" href="gio-GIOError.html#GIOErrorEnum">GIOErrorEnum</a>        <a class="link" href="gio-GIOError.html#g-io-error-from-errno">g_io_error_from_errno</a>               (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> err_no);

</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2801834"></a><h2>Description</h2>
<p>
Contains helper functions for reporting errors to the user.</p>
<p>

</p>
</div>
<div class="refsect1" lang="en">
<a name="id2782942"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2814738"></a><h3>
<a name="G-IO-ERROR:CAPS"></a>G_IO_ERROR</h3>
<a class="indexterm" name="id2814751"></a><pre class="programlisting">#define G_IO_ERROR g_io_error_quark()
</pre>
<p>
Error domain for GIO. Errors in this domain will be from the <a class="link" href="gio-GIOError.html#GIOErrorEnum"><span class="type">GIOErrorEnum</span></a> enumeration.
See <a
href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"
><span class="type">GError</span></a> for more information on error domains.</p>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2814788"></a><h3>
<a name="GIOErrorEnum"></a>enum GIOErrorEnum</h3>
<a class="indexterm" name="id2814800"></a><pre class="programlisting">typedef enum
{
  G_IO_ERROR_FAILED,
  G_IO_ERROR_NOT_FOUND,
  G_IO_ERROR_EXISTS,
  G_IO_ERROR_IS_DIRECTORY,
  G_IO_ERROR_NOT_DIRECTORY,
  G_IO_ERROR_NOT_EMPTY,
  G_IO_ERROR_NOT_REGULAR_FILE,
  G_IO_ERROR_NOT_SYMBOLIC_LINK,
  G_IO_ERROR_NOT_MOUNTABLE_FILE,
  G_IO_ERROR_FILENAME_TOO_LONG,
  G_IO_ERROR_INVALID_FILENAME,
  G_IO_ERROR_TOO_MANY_LINKS,
  G_IO_ERROR_NO_SPACE,
  G_IO_ERROR_INVALID_ARGUMENT,
  G_IO_ERROR_PERMISSION_DENIED,
  G_IO_ERROR_NOT_SUPPORTED,
  G_IO_ERROR_NOT_MOUNTED,
  G_IO_ERROR_ALREADY_MOUNTED,
  G_IO_ERROR_CLOSED,
  G_IO_ERROR_CANCELLED,
  G_IO_ERROR_PENDING,
  G_IO_ERROR_READ_ONLY,
  G_IO_ERROR_CANT_CREATE_BACKUP,
  G_IO_ERROR_WRONG_ETAG,
  G_IO_ERROR_TIMED_OUT,
  G_IO_ERROR_WOULD_RECURSE,
  G_IO_ERROR_BUSY,
  G_IO_ERROR_WOULD_BLOCK,
  G_IO_ERROR_HOST_NOT_FOUND,
  G_IO_ERROR_WOULD_MERGE,
  G_IO_ERROR_FAILED_HANDLED
} GIOErrorEnum;
</pre>
<p>
Error codes returned by GIO functions.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-FAILED:CAPS"></a><code class="literal">G_IO_ERROR_FAILED</code></span></p></td>
<td> Generic error condition for when any operation fails.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-FOUND:CAPS"></a><code class="literal">G_IO_ERROR_NOT_FOUND</code></span></p></td>
<td> File not found error.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-EXISTS:CAPS"></a><code class="literal">G_IO_ERROR_EXISTS</code></span></p></td>
<td> File already exists error.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-IS-DIRECTORY:CAPS"></a><code class="literal">G_IO_ERROR_IS_DIRECTORY</code></span></p></td>
<td> File is a directory error.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-DIRECTORY:CAPS"></a><code class="literal">G_IO_ERROR_NOT_DIRECTORY</code></span></p></td>
<td> File is not a directory.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-EMPTY:CAPS"></a><code class="literal">G_IO_ERROR_NOT_EMPTY</code></span></p></td>
<td> File is a directory that isn't empty.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-REGULAR-FILE:CAPS"></a><code class="literal">G_IO_ERROR_NOT_REGULAR_FILE</code></span></p></td>
<td> File is not a regular file.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-SYMBOLIC-LINK:CAPS"></a><code class="literal">G_IO_ERROR_NOT_SYMBOLIC_LINK</code></span></p></td>
<td> File is not a symbolic link.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-MOUNTABLE-FILE:CAPS"></a><code class="literal">G_IO_ERROR_NOT_MOUNTABLE_FILE</code></span></p></td>
<td> File cannot be mounted.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-FILENAME-TOO-LONG:CAPS"></a><code class="literal">G_IO_ERROR_FILENAME_TOO_LONG</code></span></p></td>
<td> Filename is too many characters.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-INVALID-FILENAME:CAPS"></a><code class="literal">G_IO_ERROR_INVALID_FILENAME</code></span></p></td>
<td> Filename is invalid or contains invalid characters.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-TOO-MANY-LINKS:CAPS"></a><code class="literal">G_IO_ERROR_TOO_MANY_LINKS</code></span></p></td>
<td> File contains too many symbolic links.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NO-SPACE:CAPS"></a><code class="literal">G_IO_ERROR_NO_SPACE</code></span></p></td>
<td> No space left on drive.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-INVALID-ARGUMENT:CAPS"></a><code class="literal">G_IO_ERROR_INVALID_ARGUMENT</code></span></p></td>
<td> Invalid argument.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-PERMISSION-DENIED:CAPS"></a><code class="literal">G_IO_ERROR_PERMISSION_DENIED</code></span></p></td>
<td> Permission denied.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-SUPPORTED:CAPS"></a><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></span></p></td>
<td> Operation not supported for the current backend.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-NOT-MOUNTED:CAPS"></a><code class="literal">G_IO_ERROR_NOT_MOUNTED</code></span></p></td>
<td> File isn't mounted.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-ALREADY-MOUNTED:CAPS"></a><code class="literal">G_IO_ERROR_ALREADY_MOUNTED</code></span></p></td>
<td> File is already mounted.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-CLOSED:CAPS"></a><code class="literal">G_IO_ERROR_CLOSED</code></span></p></td>
<td> File was closed.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-CANCELLED:CAPS"></a><code class="literal">G_IO_ERROR_CANCELLED</code></span></p></td>
<td> Operation was cancelled. See <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-PENDING:CAPS"></a><code class="literal">G_IO_ERROR_PENDING</code></span></p></td>
<td> Operations are still pending.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-READ-ONLY:CAPS"></a><code class="literal">G_IO_ERROR_READ_ONLY</code></span></p></td>
<td> File is read only.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-CANT-CREATE-BACKUP:CAPS"></a><code class="literal">G_IO_ERROR_CANT_CREATE_BACKUP</code></span></p></td>
<td> Backup couldn't be created.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-WRONG-ETAG:CAPS"></a><code class="literal">G_IO_ERROR_WRONG_ETAG</code></span></p></td>
<td> File's Entity Tag was incorrect.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-TIMED-OUT:CAPS"></a><code class="literal">G_IO_ERROR_TIMED_OUT</code></span></p></td>
<td> Operation timed out.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-WOULD-RECURSE:CAPS"></a><code class="literal">G_IO_ERROR_WOULD_RECURSE</code></span></p></td>
<td> Operation would be recursive.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-BUSY:CAPS"></a><code class="literal">G_IO_ERROR_BUSY</code></span></p></td>
<td> File is busy.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-WOULD-BLOCK:CAPS"></a><code class="literal">G_IO_ERROR_WOULD_BLOCK</code></span></p></td>
<td> Operation would block.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-HOST-NOT-FOUND:CAPS"></a><code class="literal">G_IO_ERROR_HOST_NOT_FOUND</code></span></p></td>
<td> Host couldn't be found (remote operations).
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-WOULD-MERGE:CAPS"></a><code class="literal">G_IO_ERROR_WOULD_MERGE</code></span></p></td>
<td> Operation would merge files.
</td>
</tr>
<tr>
<td><p><span class="term"><a name="G-IO-ERROR-FAILED-HANDLED:CAPS"></a><code class="literal">G_IO_ERROR_FAILED_HANDLED</code></span></p></td>
<td> Operation failed and a helper program has already interacted with the user. Do not display any error dialog.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2761866"></a><h3>
<a name="g-io-error-from-errno"></a>g_io_error_from_errno ()</h3>
<a class="indexterm" name="id2761878"></a><pre class="programlisting"><a class="link" href="gio-GIOError.html#GIOErrorEnum">GIOErrorEnum</a>        g_io_error_from_errno               (<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> err_no);</pre>
<p>
Converts errno.h error codes into GIO error codes.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>err_no</code></em>&#160;:</span></p></td>
<td> Error number as defined in errno.h.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a class="link" href="gio-GIOError.html#GIOErrorEnum"><span class="type">GIOErrorEnum</span></a> value for the given errno.h error number.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2814846"></a><div class="refsect2" lang="en"><a name="id2814847"></a></div>
<hr>
<div class="refsect2" lang="en"><a name="id2814848"></a></div>
</div>
</div>
</body>
</html>
